home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
130 MIDI Tool Box
/
130 MIDI Tool Box.iso
/
waz_ime
/
waz_ime.doc
< prev
next >
Wrap
Text File
|
1991-08-20
|
28KB
|
692 lines
WAZ_IME - WazWare Integrated MIDI Environment
Version 1.00a
("a follow on to WAZMIDI MIDI utility")
(c) 1991 by Wayne G.Hall
All rights reserved.
█
█ ██████████████ █████
█ ██ █████
█ █ ███ ██ █ █ █ █
█ █ █ █ █ ██ █ █ █ █ █ █
█ █ █ ███ ██ █ █ █ ███
█ █ █ █ █ ██ █ █ █ █ █ █
█████ █ ██ █ █ █ █ █
█████ █ ████████████ █ █ ███ █
█
█ █ ███ █ █ █ ███ █ █
█ █ █ █ █ █ █ █ █
█ █ █ █ ██ █ █ ███
█ █ █
████ ████████████████
███ ███
█ █
███ ███
Distributed & Written by:
WazWare Custom Software
Wayne G. Hall
60 Beechwood Avenue
Sudbury, Massachusetts 01776-1551, USA
Electronic mail to:
PRODIGY ID: WSBG41A
WHITE ZONE MIDI BBS: 1-617-969-3138 or 1-617-969-3924
Program & Documentation (c) 1991 WazWare Custom Software all rights
reserved.
ACKNOWLEDGEMENTS
----------------
I could not assemble a product like WAZ_IME without the help of people who
have supported me hacking with MIDI. My sincere appreciation to you, you know
who you are! I would also like to thank my wife for putting up with me during
this time (it's gotta be said)...
Copyright portions:
- Copyright 1987, 1989 Music Quest
- Copyright 1987, 1988 Borland International
- Copyright 1989, 1990 Turbo Power Software
The following tools were used creating WAZ_IME:
- Turbo Pascal V5.5 (Borland International)
- Turbo Assembler 1.5 (Borland International)
- Object Professional 1.0 (Turbo Power Software)
- Music Quest MIDI Interface Toolkit (Music Quest,Inc.)
TABLE OF CONTENTS
-----------------
Introduction
WAZ_IME Features
Installation & Use
Registration Information & Technical Support
Contents:
WAZ_IME.EXE 296288 8-20-1991 10:00:00 pm Program
SAMPLE.CFG 9 8-20-1991 09:00:00 pm Optional sample configuration file
WAZ_IME.DOC 28111 8-20-1991 10:00:00 pm This document
Introduction
------------
Greetings, and thanks for checking out WAZ_IME. I particularly thank you for
reading this document (at least this far). It's comforting to know someone
reads this. I do enjoy writing code not documents !
Let me get this point out of the way right up front. I refer to myself as a
"hacker" as slang for "ye ol' basement programmer", not a cab driver, horse or
some coughing buffoon. I use the term "HACKER" as more of a "writer for hire"
but definitely NOT one of those deranged crackpot's who get their jollies
creating virus's.
WAZ_IME was designed to serve as a tool to tweak and twiddle MIDI data. I
hope you'll find WAZ_IME provides an assortment of capabilities for hacking
with MIDI devices. WAZ_IME is a beefed up version of WAZMIDI (my first midi
utility). This version added many more features intended to allow the user to
stay in one integrated environment to experiment.
WAZ_IME is provided on an "as is" basis without warranty of any kind express
or implied. In no event will Wayne Hall (the Author), be liable to you for
any damages, including any lost profits, lost savings or other incidental or
consequential damages arising out of the use of or inability to use WAZ_IME,
even if the Author has been advised of the possibility of such damages, or for
any claim by any other party.
WAZ_IME is copyrighted by the Wayne Hall, Borland International, Music Quest &
Turbo Power. You are encouraged to give copies to your friends and upload it
to bulletin boards, however sale of WAZ_IME for profit by anyone except the
Author is strictly prohibited. If you use this program and find it to be of
value, your contribution would be greatly appreciated. Contributions are
$5.00, feature requests and employment opportunities. Any specific requests I
will attempt to accommodate. Regardless of contribution, if you use WAZ_IME
then at least send your comments.
Example contribution:
"Assign function keys to specific menu items, possibly custom to order."
Send contributions,
feature request,
employment opportunities to:
WazWare Custom Software
Wayne G. Hall
60 Beechwood Avenue
Sudbury, Massachusetts 01776-1551, U.S.A.
Let me know where you received WAZ_IME and what you would like to see in
future releases. Contributors will receive notification when new releases
become available. Customized versions may be available. Send me a letter
detailing your requirements and we can possibly work something out.
WAZ_IME Features
----------------
What is WAZ_IME and why would anyone use it? Chances are that you downloaded
this file from a BBS since that's my primary scattering path.
** new with WAZ_IME * updated from WazMidi
MIDI & Misc DOOHICKEY'S:
** Menu interface with mouse support
** EGA/VGA support (43/50 line mode)
** Midi byte interpreter
** Midi bulk data dump with optional delays (milli seconds)
** Midi text ".HEX" file editor
** Bulk dump block of ".HEX" file to midi device
** Pop-up HEXADECIMAL/DECIMAL/BINARY chart.
** User select MIDI IRQ and address
* Midi bytes reader/saver
* System exclusive message send (10 bytes, send & catch or send only)
* Program/Channel change
* Viewer for ".HEX" files
* Compare byte by byte ".HEX" files
- Easy installation/set up/configuration
- Not copy protected
- Shareware. Try it out before you contribute.
- Technical support via "THE WHITE ZONE BBS" a midi bbs
DOS PARAPHERNALIA:
** File Viewer
** Text Editor
** Copy Files
** Delete Files
** Rename Files
** Create Files
** Create Directories
** DOS Shell (swaps to EMS or DISK)]
** Print file with user select header and font
INSTALLATION
------------
System requirements:
IBM XT, AT compatible. (hail to the clone)
DOS 2.0 or higher.
1 floppy drive or preferably a hard disk.
512K Ram
Midi 401 compatible card
Nice to have:
Color monitor
Fast harddrive
EMS memory
Ramdrive
Mouse
The first thing you should do is make a backup copy of the original WAZ_IME
disk. It's not copy protected, so you can use diskcopy or just do a copy *.*.
Installation should be quite easy because of only one file. If you have a MIDI
card (I hope so) WAZ_IME will prompt you to create WAZ_IME.CFG which is a
configuration file where the Midi card address and IRQ information is stored.
This file is not required. WAZ_IME will ask for this data at the start and
prompt you if you would like to save it. If you choose to save the
configuration file it will automatically be used each time you run WAZ_IME. I
would suggest making directory C:\WAZ_IME and create subdirectory
C:\WAZ_IME\HEXFILES to store your files created with WAZ_IME. I have included
sample WAZ_IME.CFG file so you can see what it looks like. You can use
WAZ_IME's editor to change it if you wish. If you change the IRQ and Address
configuration you must restart program to take effect. The sample WAZ_IME.CFG
has address 330 and irq 2 which is most common. Check information supplied
with MIDI card for your settings.
The main screen has DOS information constantly displayed as well as MIDI
address, IRQ and **byte delays setting.
** Byte delays are user select delays which can be used when
bulk data files are sent. It was found that some data dumps
require some delay between bytes and at end of System Exclusive
message. The delay can be set between 0-127 milli seconds. If
you find a case where WAZ_IME is incompatible with something,
drop me a line and let me know.
BE AS SPECIFIC AS YOU CAN !
Once again the address is:
WazWare Custom Software
Wayne G. Hall
60 Beechwood Avenue
Sudbury, Massachusetts 01776-1551, USA
WAZ_IME USE
-----------
MAIN SCREEN
-----------
The menu screen provides updated status information.
- RAM: DOS, EXTENDED & EMS
- Version of DOS
- Coproccessor
- Current Disk Volume label
- Current Disk Drive
- Disk Byte/sector, available bytes
- Current file selected
- MIDI IRQ
- MIDI ADDRESS
- Delay milli seconds between bytes/after system exclusive F7.
HOT KEY FUNCTIONS
-----------------
The following keyboard function keys are provided as quicker access to pull
down menu functions. All of these are described in the following section.
- F1 key = POP UP CHART DEC/HEX/BIN
- F2 key = Information on WAZ_IME
- F3 key = Program change
- F4 key = System exclusive with catch data
- F5 key = Bulkdump
- F6 key = Midi Reader
- F7 key = Delay F7
- F8 key = Delay byte
- F9 key = OS Shell
- F10 key = Screen Size
OS OPTIONS
----------
These tools are common tools for utilities which use DOS files. I've tried to
provide a way to create, edit, view, save, delete and rename .HEX files which
is what WAZ_IME is based on. The tools are generic to all DOS files for the
most part except for the editor, it is just for text files.
VIEW FILE
---------
When you select view file via key or mouse you will be prompted for option to
create tree of entire drive, current directory or enter complete
drive\path\filename. The tree and directory choice will provide a easy way to
pick a file to view using the mouse. If you know specifically what file you
want choose "Enter Path/File". Once you have selected a file WAZ_IME will
maintain it as the current file so you can pick it much quicker in another
tool. An example would be to check the drive for a particular Bulk Data file
to dump but you just want a peek, if you select it for viewing WAZ_IME will
change pick file to that last choice so when you go to send just pick Enter
Path/File and your last pick will be default. The method of selecting a file
found in the VIEW FILE is used throughout WAZ_IME to pick a file. Press F1
for help using viewer while in viewer.
EDIT FILE
---------
The editor is similar to the VIEW FILE except you can edit test files up to
64K. If you are familiar with WordStar type commands you'll find it easy to
use (sorry if you don't, but custom commands are not out of the question). I
find it very comfortable due to my compiler uses the same controls for
editing. The same editor with different screen size is implemented for MIDI
data editing in WazScanEdit. Press F1 for help using editor while in editor.
LOG DRIVE
---------
This just allows you to change disk drives. It attempts to tell you what is
there and determine status. Single floppy systems will mess up screen with
messages to press key for next drive. This is due to the fact that WAZ_IME
tests for existing drives A-Z. Probably one of the weak spots in WAZ_IME, any
suggestions?
NEW FILE
--------
Allows you to create an empty text file of your choice. Default file name is
WAZNEW.HEX on current root directory.
MAKE DIRECTORY
--------------
Allows you to create an empty directory of your choice. Default directory is
\WAZNEWDIR on current drive.
COPY FILE
---------
Allows a way to copy a file without leaving WAZ_IME to dos.
DELETE FILE
-----------
Allows a way to delete a file without leaving WAZ_IME to dos.
RENAME FILE
-----------
Allows a way to rename a file without leaving WAZ_IME to dos.
SCREEN SIZE [ hot key F10 ]
----------------------------
Selecting this will toggle your display between 25 & 43/50 line mode on
EGA/VGA screens. It will do nothing on other display types.
OS SHELL [ hot key F9 ]
------------------------
Provides a way of popping out to DOS to do other tasks under dos without
terminating WAZ_IME. Shelling out with WAZ_IME usually provides
enough memory to do most tasks due to the memory/disk swapping used when you
shell out. WAZ_IME will swap WAZ_IME to EMS if it exists or disk to provide
as much ram as possible for running a program. WAZ_IME is a fairly large
program but with swapping you can still crank some serious applications while
WAZ_IME is still in memory.
INFORMATION [ hot key F2 ]
---------------------------
WazWare WAZ_IME information novelty...
PRINT
-----
FILE TO PRINT
-------------
When you select file to print via key or mouse you will be prompted for three
options; create tree of entire drive, current directory or enter complete
drive\path\filename. The tree and directory choice will provide a easy way to
pick a file to print using the mouse. If you know specifically what file you
want choose "Enter Path/File". The print file will print any text file and
paginate assuming 8.5"x11" paper for fonts selected. All printing assumes
LPT1 and Epson or compatible dot matrix printer.
HEADING
-------
Allows you to type in a header which will be printed on each page of file
printed. No header will leave blank line on each page.
SET FONT
--------
Allows you to easily select font for Epson or compatible dot matrix printer.
Available fonts are 5, 10, 12, 17 & 20 pitch in draft, bold or bold italic.
RESET
-----
Bios reset of line printer on LPT1
LINEFEED
--------
Linefeed of line printer on LPT1
FORMFEED
--------
Formfeed of line printer on LPT1
Sample print:
FILE: WAZ_MIDI.HEX
THIS IS WHERE YOUR HEADER WOULD APPEAR ON EACH PAGE
today's date & time WazWare (c)1991
-----------------------------------
00 01 04 0F 02 03 80 00 00 01 00 05 07 0A 00 01
08 01 04 0F 02 03 80 08 08 01 08 05 07 0A 08 01
00 01 04 0F 02 03 80 00 00 01 00 05 07 0A 00 01
08 01 04 0F 02 03 80 08 08 01 08 05 07 0A 08 01
00 01 04 0F 02 03 80 00 00 01 00 05 07 0A 00 01
08 01 04 0F 02 03 80 08 08 01 08 05 07 0A 08 01
00 01 04 0F 02 03 80 00 00 01 00 05 07 0A 00 01
Page - 1 ( <- pages are numbered )
PROGRAM CHANGE [ hot key F3 ]
------------------------------
Allows you to send MIDI program changes on any midi channel. Use of plus,
minus, up, down, page up & page down key allow selection of MIDI channel and
program prior to sending change via enter key. This is the same as original
program change in WazMidi.
SYSEX
-----
SYSEX & Catch [ hot key F4 ]
-----------------------------
This allows the user to create system exclusive message and send it and
capture the result return data from device message was sent to. It creates a
ten byte message which you can see displayed in hex/dec and binary on screen
prior to sending. Each byte is adjusted by using arrow, page or plus/minus
keys. The message is sent by pressing enter or right arrow key. WAZ_IME
eliminated ability to edit first and last byte of Sysex due to lack of need
to.
SYSEX only
----------
Same as SYSEX & Catch without collecting return data.
BULKDUMP
--------
SEND BULKDATA [ hot key F5 ]
-----------------------------
This allows you to pick a .HEX file using the same methods as used throughout
WAZ_IME (tree/pick,pick from dir or enter) and send the entire file. The
sending process can be stopped by a key press or mouse click.
BYTE DELAY [ hot key F8 ]
--------------------------
The delays (byte/F7) have no independent purpose. They are to be used in
conjunction with sending data via SEND BULKDATA or WAZSCANEDIT block dump. The
delay is in milli seconds selected from 0-127ms. It was found that some data
dumps require some delay between bytes and at end of System Exclusive message.
More information is available on the White Zone BBS.
F7 DELAY [ hot key F7 ]
------------------------
Same as byte delay.
READ/SAVE [ hot key F6 ]
-------------------------
This is a midi monitor of sorts, where it allows you create a text file which
will capture and display all midi data input to your midi card. It is the
same routine used on SYSEX with catch. With this release I have added the
ability to append existing .HEX files.
MIDI OPTIONS
------------
COMPARE .HEX FILES
------------------
This compares two .HEX files byte by byte and reports differences. Keep in
mind .HEX files are just text files which are in hexadecimal notation.
Therefore they will be larger in size than actual byte count.
MIDI INTERPRETER
----------------
This works similar to READ/SAVE except it does not save received data. In
addition to hexadecimal data it will display types of messages being sent.
This is a preliminary module...
examples: System Exclusive
Program Change
WAZMIDISCAN
-----------
The WazMidiScan was in WazMidi original release. It is a text file viewer
displayed in a window (16x16 byte format) to view .HEX files. With this
release I have added display references for byte location in decimal and hex
on each side of window. The byte count total displayed on lower
screen is
accurate for the file. The byte location indicators on each side are only
valid for .HEX files with have no blank spots visible (typically
from F7 which
adds carriage return in .HEX file.
WAZHEXBIN CHART [ hot key F1 ]
-------------------------------
Quick reference chart for Decimal, Hexadecimal and Binary numbers from 0-256.
You can access it via F1 or on Midi Option menu.
WAZSCANEDIT
-----------
The WazScanEdit is the same as the text editor under DOS options. The features
are the ability to edit/save .HEX files and send portions of .HEX files rather
than the entire file as Bulkdump does. You still have the delays which are
global settings in WAZ_IME.
Registration Information & Technical Support
--------------------------------------------
WAZ_IME is a copyrighted program, if you obtained WAZ_IME from a shareware
disk vendor, an on-line computer service or bulletin board, a friend or
colleague, or another similar source, you have an unregistered (trial) copy.
You are authorized to use this copy without charge for a limited period of
time ( say 45 days is fair ). After this time, you should register WAZ_IME to
continue using it. This method of distribution is known as shareware. It
allows you to determine whether WAZ_IME meets your needs before you pay for
it. I don't want your contributions unless you are a user. I also expect
feature requests with each contribution. This allows me to get direct feed
back from real users so I can improve your tool.
The registration fee for a single copy of WAZ_IME is up to you. Contributions
of $15.00 entitles you to:
* A disk with the latest version of WAZ_IME, registered to you.
* Your requests get on my "to do" list for upgrades
* Satisfaction guarantee don't contribute is your not satisfied.
Name_____________________________________________________________
Address_____________________________________________________________
_____________________________________________________________
Phone _____________________________________________________________
Diskette size: ____ 5.25" acceptable ____ 3.5 required
I have read and agree to abide by the WAZ_IME agreement:
Signature__________________________________________________________
Where did you hear about or get WAZ_IME ?
Quantity: ______ x $15.00 = $__________
($15.00/copy)
Shipping charges, per copy: $__________
($1.00/copy USA)
Total enclosed: $__________
WAZ_IME technical support policy
--------------------------------
With this release (V1.00), there really isn't any specific support policy. I
will listen and respond as best I can. I hope this will be fair for you. You
see this is a "experiment of sorts" with shareware concept. In the past I
have written smaller utilities and posted them as Public Domain. I'm not
expecting to get rich and retire to Florida with revenue from this. When I do
retire to Florida I hope to continue writing code for anyone who will use it.
I would like your user feed back even if you choose not to contribute. Either
write to me (I will respond! promise..) or call "THE WHITE ZONE" MIDI BBS and
leave me a message, while your there you can check out the system.
WHITE ZONE MIDI BBS
David Saganey Sysop
1-617-969-6230 or 1-617-969-3924
If this release can at least get some feed back I will be encouraged to
continue writing utilities based on user request (cause that's what I like).
"Programming is a wonderful obsession!" Recognize I don't make a living doing
this so you will not get 24 hour on site support! Lets be fair I will respond
via mail or email but please don't trace down the phone number and call (the
wife is already fed up with the basement programming, undesired phone calls
would put me in deep #@%$!). You see, I'm not some big software company. I'm
just a guy with an idea and appetite to write code. To continue support I'll
need your support ok folks.... ENJOY!
Y o u r m o v e . . .